Skip to content

微信支付批次单号查询批次单

微信支付批次单号查单接口。转账处理后延迟一段时间(异步进行转账),服务商可以通过该接口查询转账批次单以及指定状态的转账明细单。

请求参数类型描述
batch_idstring微信支付批次单号
queryobject声明请求的查询参数
need_query_detailboolean是否查询转账明细单
offsetinteger请求资源起始位置
limitinteger最大资源条数
detail_statestring明细状态
ALL | SUCCESS | FAIL 枚举值之一
php
$instance->v3->bankTransfer->batches->batchId->_batch_id_->getAsync([
  'batch_id' => '1130000071100999991182020050700019480001',
  'query' => [
    'need_query_detail' => true,
    'offset'            => 0,
    'limit'             => 20,
    'detail_state'      => 'FAIL',
  ],
])
->then(static function(\Psr\Http\Message\ResponseInterface $response) {
  print_r(json_decode((string) $response->getBody(), true));
})
->wait();
php
$instance->chain('v3/bank-transfer/batches/batch-id/{batch_id}')->getAsync([
  'batch_id' => '1130000071100999991182020050700019480001',
  'query' => [
    'need_query_detail' => true,
    'offset'            => 0,
    'limit'             => 20,
    'detail_state'      => 'FAIL',
  ],
])
->then(static function(\Psr\Http\Message\ResponseInterface $response) {
  print_r(json_decode((string) $response->getBody(), true));
})
->wait();
php
$instance['v3/bank-transfer/batches/batch-id/{batch_id}']->getAsync([
  'batch_id' => '1130000071100999991182020050700019480001',
  'query' => [
    'need_query_detail' => true,
    'offset'            => 0,
    'limit'             => 20,
    'detail_state'      => 'FAIL',
  ],
])
->then(static function(\Psr\Http\Message\ResponseInterface $response) {
  print_r(json_decode((string) $response->getBody(), true));
})
->wait();
php
$response = $instance->v3->bankTransfer->batches->batchId->_batch_id_->get([
  'batch_id' => '1130000071100999991182020050700019480001',
  'query' => [
    'need_query_detail' => true,
    'offset'            => 0,
    'limit'             => 20,
    'detail_state'      => 'FAIL',
  ],
]);
print_r(json_decode((string) $response->getBody(), true));
php
$response = $instance->chain('v3/bank-transfer/batches/batch-id/{batch_id}')->get([
  'batch_id' => '1130000071100999991182020050700019480001',
  'query' => [
    'need_query_detail' => true,
    'offset'            => 0,
    'limit'             => 20,
    'detail_state'      => 'FAIL',
  ],
]);
print_r(json_decode((string) $response->getBody(), true));
php
$response = $instance['v3/bank-transfer/batches/batch-id/{batch_id}']->get([
  'batch_id' => '1130000071100999991182020050700019480001',
  'query' => [
    'need_query_detail' => true,
    'offset'            => 0,
    'limit'             => 20,
    'detail_state'      => 'FAIL',
  ],
]);
print_r(json_decode((string) $response->getBody(), true));
返回字典类型描述
bank_sp_mchidstring银行服务商号
platform_mchidstring服务平台商户号
specialized_payment_mchidstring付款企业商户号
sponsor_mchidstring实际出资商户号
user_authorized_mchidstring用户授权商户号
user_authorized_appidstring用户授权appid
out_batch_nostring银行批次单号
batch_idstring微信支付批次单号
transfer_scenestring转账场景
ORDINARY_TRANSFER | PAYROLL_CARD_TRANSFER 枚举值之一
batch_namestring批次名称
batch_remarkstring批次备注
attach_remarkstring附加信息
transfer_purposestring批量转账用途
GOODSPAYMENT | COMMISSION | REFUND | REIMBURSEMENT | FREIGHT | OTHERS 枚举值之一
batch_statestring批次状态
ACCEPTED | PROCESSING | FINISHED | CLOSED 枚举值之一
close_reasonstring批次关闭原因
MERCHANT_REVOCATION | OVERDUE_CLOSE 枚举值之一
total_amountinteger转账总金额
total_countinteger转账总笔数
create_timestring批次创建时间
update_timestring批次更新时间
success_amountinteger转账成功金额
success_countinteger转账成功笔数
fail_amountinteger转账失败金额
fail_countinteger转账失败笔数
transfer_detail_listobject[]转账明细单列表
detail_idstring微信支付明细单号
out_detail_nostring银行明细单号
detail_statestring明细状态
PROCESSING | SUCCESS | REFUND 枚举值之一
fail_reasonstring明细失败原因
ACCOUNT_FROZEN | REAL_NAME_CHECK_FAIL | NAME_NOT_CORRECT | OPENID_INVALID | TRANSFER_QUOTA_EXCEED | DAY_RECEIVED_QUOTA_EXCEED | MONTH_RECEIVED_QUOTA_EXCEED | DAY_RECEIVED_COUNT_EXCEED | PRODUCT_AUTH_CHECK_FAIL | OVERDUE_CLOSE | ID_CARD_NOT_CORRECT | ACCOUNT_NOT_EXIST | TRANSFER_RISK | PAYROLL_CARD_ALREADY_LOGOUT | PAYROLL_CARD_ALREADY_FROZEN | PAYROLL_CARD_UNAUTHORIZED | PAYROLL_CARD_USER_NOT_OPEN | PAYROLL_CARD_NAME_CARD_NOT_MATCH | PAYROLL_CARD_ID_CARD_NOT_MATCH | PAYROLL_CARD_BANKCARD_UNBUNDLING | BANK_CARD_COLLECTIONS_ABOVE_QUOTA | BANK_CARD_ACCOUNT_ABNORMAL | BANK_CARD_STATUS_ABNORMAL | BANK_CARD_BANK_INFO_WRONG | BANK_CARD_CARD_INFO_WRONG | OTHER_FAIL_REASON_TYPE | REALNAME_ACCOUNT_RECEIVED_QUOTA_EXCEED | TRANSFER_REMARK_SET_FAIL 枚举值之一

参阅 官方文档

Published on the GitHub by TheNorthMemory